home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
libelfutil
/
_leb128_unsigned_decode64.z
/
_leb128_unsigned_decode64
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
____LLLLEEEEBBBB111122228888____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____DDDDEEEECCCCOOOODDDDEEEE66664444((((3333EEEE)))) ____LLLLEEEEBBBB111122228888____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____DDDDEEEECCCCOOOODDDDEEEE66664444((((3333EEEE))))
NNNNAAAAMMMMEEEE
______llll_eeee_bbbb_1111_2222_8888______uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_6666_4444: ______llll_eeee_bbbb_1111_2222_8888______ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_6666_4444:
______llll_eeee_bbbb_1111_2222_8888______uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_3333_2222: ______llll_eeee_bbbb_1111_2222_8888______ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_3333_2222 - decode leb128
integers
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
_####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_mmmm_pppp_llll_rrrr_ssss_////_llll_eeee_bbbb_1111_2222_8888_...._hhhh_>>>>
_iiii_nnnn_tttt ______llll_eeee_bbbb_1111_2222_8888______uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_6666_4444_((((_cccc_hhhh_aaaa_rrrr_**** _dddd_aaaa_tttt_aaaa_,,,, ___________uuuu_iiii_nnnn_tttt_6666_4444______tttt_**** _vvvv_aaaa_llll_uuuu_eeee_))))_;;;;
_iiii_nnnn_tttt ______llll_eeee_bbbb_1111_2222_8888______ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_6666_4444_((((_cccc_hhhh_aaaa_rrrr_**** _dddd_aaaa_tttt_aaaa_,,,, ___________iiii_nnnn_tttt_6666_4444______tttt_**** _vvvv_aaaa_llll_uuuu_eeee_))))_;;;;
_iiii_nnnn_tttt ______llll_eeee_bbbb_1111_2222_8888______uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_3333_2222_((((_cccc_hhhh_aaaa_rrrr_**** _dddd_aaaa_tttt_aaaa_,,,, ___________uuuu_iiii_nnnn_tttt_3333_2222______tttt_**** _vvvv_aaaa_llll_uuuu_eeee_))))_;;;;
_iiii_nnnn_tttt ______llll_eeee_bbbb_1111_2222_8888______ssss_iiii_gggg_nnnn_eeee_dddd______dddd_eeee_cccc_oooo_dddd_eeee_3333_2222_((((_cccc_hhhh_aaaa_rrrr_**** _dddd_aaaa_tttt_aaaa_,,,, ___________iiii_nnnn_tttt_3333_2222______tttt_**** _vvvv_aaaa_llll_uuuu_eeee_))))_;;;;
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
These routines decode leb128 numbers into the integers they encode. The
leb128 format is a variable-length encoding extensively used in the DWARF
debugging information format and is described in the DWARF documentation.
The caller must know if the leb128 number data in hand is 32 or 64 bit
and if it is signed or unsigned: nothing in the leb128 format makes it
possible to determine this from the input _d_a_t_a itself.
If a _d_a_t_a points to a number which fits in 32 bits either the 32bit or
64bit decoding routine may be called: the correct value is returned
through the _v_a_l_u_e pointer. If _d_a_t_a points at a number too large to fit
in 32 bits both the returned-value *and* the number of bytes returned by
either of the 32-bit functions will be incorrect.
The decoded number is placed into _d_a_t_a and the number of bytes of _d_a_t_a
which held the number is returned.
Link with the option -lelfutil to link in these routines.
The arguments are as follows:
_d_a_t_a is a pointer to the input number to be converted from leb128 format
into an integer.
_v_a_l_u_e
is a pointer to properly aligned space (provided by the caller) to
which the called routine writes the decoded integer value.
FFFFIIIILLLLEEEESSSS
/usr/include/cmplrs/leb128.h
/usr/lib/libelfutil.a
/usr/lib32/libelfutil.a
/usr/lib64/libelfutil.a
PPPPaaaaggggeeee 1111
____LLLLEEEEBBBB111122228888____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____DDDDEEEECCCCOOOODDDDEEEE66664444((((3333EEEE)))) ____LLLLEEEEBBBB111122228888____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____DDDDEEEECCCCOOOODDDDEEEE66664444((((3333EEEE))))
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
Returns the number of bytes found and used in decoding the number. The
returned value will be in the range 1 to 5 for the 32-bit number input
versions. The returned value will be in the range 1 to 10 for the 64-bit
number input versions.
If a number is erroneously encoded for the call (if the decoded value
will not fit in the provided _v_a_l_u_e pointed to) there is no error
indication: instead a value is returned and the length returned is 5 (for
the 32bit versions) or 10 (for the 64bit versions).
SSSSEEEEEEEE AAAALLLLSSSSOOOO
libelfutil(5), xlate(4), _leb128_unsigned_encode64,
_leb128_unsigned_encode32, _leb128_signed_encode64,
_leb128_signed_encode32, DWARF Debugging Information Format , A Consumer
Library Interface to DWARF
PPPPaaaaggggeeee 2222